home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 002a / mlcrux10.zip / MLCRUX.DOC next >
Text File  |  1991-12-16  |  19KB  |  541 lines

  1.               MicroLink Personal Computer Users' Group
  2.  
  3.                              Presents
  4.  
  5.                                Crux
  6.  
  7.                  v1.0, Copyright 1991, Bob Lancaster
  8.  
  9.  
  10. INTRODUCTION
  11.  
  12.    Crux is a colorful puzzle/game in which players try to achieve high
  13.    score by placing multicolored cross-shaped pieces (cruxes) on a
  14.    grid so that only crux-arms of the same color are touching.  The
  15.    more arms that match a newly played crux, the more points you get!
  16.  
  17.    Think of it as four-sided, color-coded dominoes!
  18.  
  19.    Each round gives you more colors to contend with, making things a
  20.    bit trickier as the game progresses.
  21.  
  22.    The word "crux" is Latin for "cross", but in English also means "a
  23.    puzzling or difficult problem".  Getting it so that the last pieces
  24.    to fit on the grid can be just that!
  25.  
  26.    Enjoy!
  27.  
  28.  
  29. EQUIPMENT REQUIRED
  30.  
  31.    Crux will run on any IBM PC/AT/XT/PS2 or close clone thereof, with
  32.    at least 100k of memory available after DOS is loaded.
  33.  
  34.    Although the game looks best when played on a color monitor, it
  35.    will work on a monochrome.  (If you are using a monochrome or
  36.    composite monitor with a color graphics card, please see "Black And
  37.    White Mode" in the Command Line Parameters section below)
  38.  
  39.    A Microsoft-compatible mouse can be used.  (Remember to load your
  40.    mouse driver before starting Crux).
  41.  
  42.    If you run across a configuration on which the game will not run,
  43.    please let me know (address at end of this file)!
  44.  
  45.  
  46. GAME FEATURES
  47.  
  48.       Microsoft Mouse Support
  49.       Fast Mode
  50.       Monochrome/Composite monitor support
  51.       Top Ten Scores file
  52.       Statistics on multiple games
  53.       Bosskey
  54.       Optional PC Opponent
  55.       On-line help
  56.       Screen Blanker during play
  57.  
  58.  
  59. THE OBJECT
  60.  
  61.    In Crux, you start each round with an empty grid of cross-shaped
  62.    spaces.
  63.  
  64.    You are dealt a hand of four-armed, cross-shaped pieces (called
  65.    "cruxes") to place on the grid.  Figure 1 shows a crux, with two
  66.    red arms, one blue arm, and one yellow arm (For purposes of this
  67.    documentation, RR=Red, BB=Blue, YY=Yellow and GG= Green).
  68.  
  69.                           +--------+
  70.                           |   YY   |
  71.                           | RR  RR |
  72.                           |   BB   |
  73.                           +--------+
  74.                        Figure 1 (A crux)
  75.  
  76.    Each Crux is played in the following manner:
  77.  
  78.       1) Using the Home/End keys (or the mouse left button), you
  79.       choose a crux from the hand.
  80.  
  81.       2) Using the cursor keys (or the mouse left button), you choose
  82.       a location for the crux.
  83.  
  84.       3) Using the Page Up/Down keys (or the right mouse button), you
  85.       rotate it so that it is aligned the way you wish.
  86.  
  87.       4) Pressing enter locks the crux in place.
  88.  
  89.    Cruxes may be placed in any empty space on the grid, as long as
  90.    each of its four arms are NOT touching a different-colored arm of
  91.    another crux.  If a crux's arms aren't touching ANY other crux, the
  92.    move is confirmed, to prevent accidental zero-point moves.
  93.  
  94.    Here's an example: Figure 2 shows a portion of the grid after some
  95.    cruxes have been played.  Note that all arms that are touching are
  96.    of the same color (RR=Red, BB=Blue, GG=Green, YY=Yellow).
  97.  
  98.             +------------------------------------+
  99.             |   RR     YY     ..     ..     YY   |
  100.             | RR  BB BB  YY ..  .. ..  .. GG  GG |
  101.             |   GG     RR     ..     ..     BB   |
  102.             |   ..     RR     ..     ..     ..   |
  103.             | ..  .. GG  YY ..  .. ..  .. ..  .. |
  104.             |   ..     BB     ..     ..     ..   |
  105.             +------------------------------------+
  106.             Figure 2 (Portion of grid during play)
  107.  
  108.    Figure 3 shows a new crux to be placed on the grid, with two green
  109.    arms, a blue and a red arm.
  110.  
  111.                           +--------+
  112.                           |   RR   |
  113.                           | GG  BB |
  114.                           |   GG   |
  115.                           +--------+
  116.                Figure 3 (New crux to be played)
  117.  
  118.    In Figure 4, two possible plays are shown (in lower case).  Notice
  119.    how the crux had to be rotated in order that the colors on its arms
  120.    matched those of neighboring cruxes.
  121.  
  122.             +------------------------------------+
  123.             |   RR     YY     ..     ..     YY   |
  124.             | RR  BB BB  YY ..  .. ..  .. GG  GG |
  125.             |   GG     RR     ..     ..     BB   |
  126.             |   gg     RR     ..     ..     bb   |
  127.             | bb  gg GG  YY ..  .. ..  .. rr  gg |
  128.             |   rr     BB     ..     ..     gg   |
  129.             +------------------------------------+
  130.                 Figure 4 (Some possible plays)
  131.  
  132.    Notice that the possible play in the lower left corner of Figure 4
  133.    has two arms which match those of its neighbors, while the one in
  134.    the lower right hand side only matches one.
  135.  
  136.    When you place a crux, the more of its arms which are touching
  137.    like-colored arms of other cruxes, the more points you earn (see
  138.    "SCORING" below)!
  139.  
  140.    After playing each crux, the used crux is replaced in your hand.
  141.  
  142.    Pay attention to the Hand window, and think ahead!  This will allow
  143.    you to place the current crux in such a way to take best advantage
  144.    of the others you can see.
  145.  
  146.  
  147. SCORING
  148.  
  149.    The number of points earned for placing a crux depends on two
  150.    things:
  151.  
  152.       - How many matching (like-colored) arms it touches.
  153.  
  154.       - What round is being played.
  155.  
  156.    The later rounds give you more colors to contend with, making
  157.    matching more and more difficult, and so more points are earned.
  158.  
  159.              +-----------------------------------------+
  160.              | Round number              1 |   2 |   3 |
  161.              +-----------------------------------------+
  162.              | Cruxes in hand            3 |   4 |   5 |
  163.              +-----------------------------------------+
  164.              | Number of colors used     3 |   4 |   5 |
  165.              |-----------------------------------------|
  166.              | Points for 1-way match    1 |   2 |   3 |
  167.              |            2-way match    3 |   6 |   9 |
  168.              |            3-way match   10 |  20 |  30 |
  169.              |            4-way match   30 |  60 |  90 |
  170.              +-----------------------------------------+
  171.              | Bonus for filling grid   50 | 100 | 150 |
  172.              +-----------------------------------------+
  173.  
  174.   A player's turn is over when he or she has either filled the grid,
  175.   or cannot find a legal place to play a given crux.
  176.  
  177.   After three rounds, the player with the highest score is the winner!
  178.  
  179.  
  180.  
  181. STARTING THE GAME
  182.  
  183.    At this point, you should be able to play the game, and get a feel
  184.    for it.  You can read the rest of this document now at your leisure
  185.    to clarify points, and to explain some of the features you might
  186.    not understand your first few times through the game.
  187.  
  188.    So, make sure you are in DOS, and type "MLCRUX" (without the
  189.    quotes) and press return.  Follow the prompts, and enjoy!
  190.  
  191.  
  192. GAME CONTROLS
  193.  
  194.    Crux can be played either using the keyboard or a Microsoft-
  195.    compatible mouse.
  196.  
  197.  
  198.    KEYBOARD INPUT
  199.  
  200.       The legend (the last line on the screen) always contains a list
  201.       of keys that are valid at any point in the game, usually along
  202.       with a one-word description of their function. (See "COMMANDS"
  203.       below)
  204.  
  205.  
  206.    MOUSE INPUT
  207.  
  208.       Most of the keys listed on the bottom line of the screen can be
  209.       entered via the mouse by pointing to the command and clicking
  210.       the left button of the mouse.  (If you are new to mice,
  211.       "clicking" something means to place the mouse cursor on it and
  212.       press the appropriate button, in this case, the left.)
  213.  
  214.       When selecting a crux from your hand, left-click the crux in the
  215.       "Hand" window.
  216.  
  217.       When placing a crux, left-click the grid location where you
  218.       want to place the crux.  Clicking the right mouse button will
  219.       rotate the crux clockwise.  Once the crux is properly aligned,
  220.       clicking it a second time with the left mouse button finishes
  221.       the placement.
  222.  
  223.       Also, boxes higher on the screen with messages such as "Press
  224.       return for next player" will allow you to click the box itself
  225.       to continue, rather than the command at the bottom of the
  226.       screen.
  227.  
  228.       So, experiment with the mouse, and see what works.  I think it's
  229.       fairly straightforward, but would appreciate any feedback on
  230.       ways you think it could be improved (address at end of file).
  231.  
  232.  
  233.  
  234. COMMANDS AND TOGGLES
  235.  
  236.    A number of commands and toggles are available to enhance play, or
  237.    to allow you to tailor the game a little to suit your taste.
  238.    Alphabetically, these are:
  239.  
  240.    A (AllScores command)
  241.  
  242.       This displays a scorecard of all players, to compare how
  243.       everyone is doing in relation to each other.  The highest
  244.       score(s) are emphasized with a flashing arrow.
  245.  
  246.    B (BossKey command)
  247.  
  248.       This displays a phony DOS screen.  I'll explain for you honest
  249.       folks: this key is used when you are playing the game on company
  250.       time, and the boss suddenly appears. To return to the game, key
  251.       OK at the phony DOS prompt.  Also known by some as the SpouseKey
  252.       command.
  253.  
  254.    D (Demo toggle)
  255.  
  256.       This allows you to put MLShut into Demo Mode, in which the
  257.       computer plays for all players.
  258.  
  259.       Defaults to "No", allowing human play.
  260.  
  261.    Esc (Exit command)
  262.  
  263.       Use this key to end MLCrux before the game is over.
  264.  
  265.    F (Fast Mode toggle)
  266.  
  267.       If you just want to play the game, and not look at some of the
  268.       "animation" (such as the "growing" score), turning the Fast Mode
  269.       on will do it.
  270.  
  271.       Defaults to "No", showing all animation.
  272.  
  273.    I (Program Info)
  274.  
  275.       Displays information about the program and the author.
  276.  
  277.    H (Hint)
  278.  
  279.       While selecting a Crux, pressing "H" will cause the
  280.       computer to show you a possible move, if any.  It may not be
  281.       your best move, though (See PC OPPONENT below)!
  282.  
  283.    N (Next Prompt toggle)
  284.  
  285.       This allows you to get rid of the "Press return for so-and-so's
  286.       turn" message, which some folks find annoying.
  287.  
  288.       Defaults to "Yes", allowing the message to show.
  289.  
  290.    P (Pips Mode)  ?????
  291.  
  292.       Allows you to select between dice with pips (dots) on them, or
  293.       with numerals on them.
  294.  
  295.       Defaults to "Yes", showing the dots.
  296.  
  297.    R (Round Prompt toggle)
  298.  
  299.       This allows you to get rid of the "Round" message, which some
  300.       folks find annoying.
  301.  
  302.       Defaults to "Yes", allowing the message to show.
  303.  
  304.    S (Sound Mode toggle)
  305.  
  306.       This allows you to turn on and off the sounds produced by the
  307.       game, which some folks find annoying.
  308.  
  309.       Defaults to "Yes", producing sound.
  310.  
  311.    T (TopTen scores command)
  312.  
  313.       Displays the highest ten scores achieved on your machine.  (This
  314.       information is stored in the file MLCRUX.SCR.  Clearing the top
  315.       ten may be done by displaying the top ten and pressing Alt-C.)
  316.  
  317.    W (Win/Loss Statistics command)
  318.  
  319.       Displays the statistics for all games played in the current
  320.       session (Since player names were entered).  These are always
  321.       shown at the end of each game, but this command allows you to
  322.       display them during play.
  323.  
  324.  
  325. COMMAND LINE PARAMETERS
  326.  
  327.    In the section above, several options are referred to as "toggles".
  328.    This simply means that they can be in a "Yes" or "No" state.
  329.  
  330.    (Note that the state of these toggles can be determined by looking
  331.    at the legend appearing at the bottom of your screen.  If the
  332.    toggle description there begins with a capital letter, the toggle
  333.    is in a "Yes" state.  For example, if a legend reads "Sound fast",
  334.    the sound toggle is set to "yes", and the fast toggle is set to
  335.    "no".)
  336.  
  337.    Each of them has a "default", which is the state (either yes or no)
  338.    in which they start out when Crux begins.
  339.  
  340.    I set the defaults to the way I felt was best, but you may think
  341.    differently!
  342.  
  343.    If you find yourself always changing one or more of the toggles
  344.    each time you play, you might want to set them on the DOS command
  345.    line instead.
  346.  
  347.    Any toggle can be flipped to the opposite of its default (Fast Mode
  348.    = "Yes", for example) by keying the toggle's letter following the
  349.    program name (MLCRUX) when you start up the game.
  350.  
  351.    So, if you wanted to set "Round Prompt" to No, and Fast Mode to
  352.    "Yes" (the opposites of their defaults), at DOS you would key:
  353.  
  354.            "MLCRUX R F"
  355.  
  356.    ...without the quotes, followed by the Return key.  Be careful that
  357.    you leave a space between MLCRUX and the toggle(s), or DOS won't
  358.    recognize what you are trying to do.
  359.  
  360.    This allows you to tailor the game a little to your taste, and if
  361.    you put this statement into a DOS batch file or menu processor, it
  362.    will save you from setting these toggles each time you start the
  363.    game.
  364.  
  365.    Toggles only valid from the command line:
  366.  
  367.    B (Black And White mode)  ??????
  368.  
  369.       If you are running a composite monitor on a color graphics card,
  370.       and the colors in MLCrux are hard to discern, keying "MLCRUX B"
  371.       at the DOS prompt will make MLCrux run in Black And White Mode.
  372.  
  373.       Note that, since Crux is a color-oriented game, the Black
  374.       and White mode makes it more difficult to play.
  375.  
  376.       Defaults to "Yes" if Monochrome adapter detected, "No"
  377.       otherwise.
  378.  
  379.    M (Mouse)
  380.  
  381.       If you have your mouse driver installed, but do not want to use
  382.       the mouse during MLCrux, keying "MLCRUX M" at the DOS prompt
  383.       will cause MLCrux to ignore the mouse.
  384.  
  385.       If you run the program without this parameter, you can still use
  386.       the keyboard.  Using this parameter simply keeps the mouse
  387.       cursor from being displayed.
  388.  
  389.       If the mouse driver is not installed, this parameter has no
  390.       effect.
  391.  
  392.       Defaults to "Yes" if mouse driver detected, "No" otherwise.
  393.  
  394.    T (Top Ten Scores)
  395.  
  396.       This is different than the "T" command available during game
  397.       play.  It specifies whether a Top Ten Scores file should be
  398.       saved, and is useful if you are running the game from a write-
  399.       protected disk.
  400.  
  401.       Defaults to "Yes".
  402.  
  403. MISCELLANEOUS
  404.  
  405.    THE PC OPPONENT
  406.  
  407.       The optional computerized opponent will play if you answer "Yes"
  408.       to the question "Play against the PC?".
  409.  
  410.       The PC opponent's strategy isn't a very good one.
  411.  
  412.       It merely looks at all of the pieces in its hand, and tries them
  413.       in every open space in the board, in all four rotations.  It
  414.       then plays the piece which gives it the highest score.  It does
  415.       NOT try to play a piece in such a way as to maximize its next
  416.       play.
  417.  
  418.       This is the same strategy the computer uses when you select a
  419.       hint, by the way.
  420.  
  421.       In future versions of the game, I might make the PC opponent
  422.       smarter, so beat it now, while you can!
  423.  
  424.  
  425. DIFFERENCE BETWEEN VERSIONS
  426.  
  427.    VERSION 0.1  -  01/01/91
  428.  
  429.       Not even a beta version, played only by author.
  430.  
  431.    VERSION 0.2  -  07/07/91,
  432.    VERSION 0.4  -  12/06/91
  433.  
  434.       Still incomplete, released to pre-beta tester.
  435.  
  436.  
  437.       Still incomplete, released to brave pre-beta tester.
  438.  
  439.    VERSION 1.0  -  12/16/91
  440.  
  441.       Initial release
  442.  
  443.  
  444. SHARING THE GAME WITH OTHERS
  445.  
  446.    Crux is shareware.  You can freely give copies of it to others,
  447.    provided that both files (MLCRUX.EXE and MLCRUX.DOC) are included,
  448.    unaltered.
  449.  
  450.    Most Shareware requires a donation for continued use.  Crux is a
  451.    little different in that registrations/donations are encouraged and
  452.    appreciated, but not required (see "Feedback" below).
  453.  
  454.    You are also encouraged to upload it to any bulletin boards which
  455.    allow the uploading of games.  For consistency's sake, please
  456.    upload the file with the file name MLCRUX10.ZIP (or .ARC, etc).
  457.    This indicates the version number (1.0), and will distinguish it
  458.    from any future versions I may produce.
  459.  
  460.  
  461. ACKNOWLEDGMENTS
  462.  
  463.    Thanks to Austin Mereno for being my beta guinea-pig.
  464.  
  465.    Thanks to Ed Tittel and Bob LeVitus for including some of my
  466.    earlier games in their "Stupid PC Tricks" and "Phenomenal PC Games"
  467.    books.
  468.  
  469.    Thanks to all those folks who wrote nice letters and left great BBS
  470.    messages in response to my other games.
  471.  
  472.    A tip o' the hat as always to the officers and members of MicroLink
  473.    PCUG for the encouragement and support they always give my PC
  474.    endeavors.
  475.  
  476.    The Tom Swan, Ben Ezzell and Jeff Duntemann mentioned in the
  477.    dedication are writers reponsible for a large body of books and
  478.    articles on (among other things) Turbo Pascal.  These gents have
  479.    been an enormous help to me and every other Turbo Pascal programmer
  480.    I know.  Anyone interested in learning the language would do well
  481.    to check into their works.
  482.  
  483.    Thanks to Eagle Performance Software, whose Shareware product
  484.    "QWIK" allows for some blazingly fast screenwrites in Turbo Pascal
  485.    and Turbo C.
  486.  
  487.      Programmers interested in QWIK should contact Eagle at:
  488.  
  489.        Eagle Performance Software      Or Call Jim LeMay at:
  490.        TP products                       (817) 735-4833
  491.        P.O. Box 122237
  492.        Fort Worth, TX  76121-2237
  493.  
  494.  
  495. ALSO BY THE AUTHOR
  496.  
  497.    MicroLink Yaht - The popular dice game
  498.  
  499.    MicroLink Shut The Box - The traditional board game
  500.  
  501.    MicroLink Otra - A memory game in the spirit of "Simon"
  502.  
  503.    MicroLink Loyd - The "15" puzzle, in competitive game form
  504.  
  505.    MicroLink Push Your Luck - A simple, fast-paced dice game
  506.  
  507.  
  508. FEEDBACK
  509.  
  510.    I would appreciate any comments, complaints, or wish lists of
  511.    features you'd like to see!  And, if you have any favorite old
  512.    games you'd like to see programmed, I'm always looking for another
  513.    which would interest me!
  514.  
  515.    Also, if you like the game enough (and can afford) to send a small
  516.    ($5) donation, I won't argue.  And my wife will understand my long
  517.    nights at the PC a little better!
  518.  
  519.    Either way: Enjoy the game, and give copies of it to all your
  520.    friends.  And enemies.  Strangers on the street...
  521.  
  522.    I can be contacted by mail at:
  523.  
  524.       Bob Lancaster / P.O. Box 5612 / Hacienda Heights, CA  91745
  525.  
  526.    Or by modem at:
  527.  
  528.       MicroLink PCUG BBS (AKA So. Cal Builder's Board)
  529.       818/961-7903 - 24hrs/365 days - 300/1200/2400/9600
  530.  
  531.    Please include the version number of Crux in correspondence.
  532.  
  533.    Those interested in finding out more about MicroLink can contact
  534.    the board listed above, or by mail:
  535.  
  536.       MicroLink PCUG Headquarters
  537.       15865-B E. Gale Ave. Box 1003
  538.       Hacienda Heights, CA  91745
  539.  
  540.    Tell them Crux sent you!
  541.